home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Night Owl 19
/
Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO
/
007a
/
ftoss102.zip
/
FILETOSS.DOC
< prev
next >
Wrap
Text File
|
1995-09-05
|
9KB
|
273 lines
FileToss - The Simple TIC processor for points
v1.02 Official Release
Copyright (C) 1995
Lawrence Gordon
All Rights Reserved
I. What is FileToss?
FileToss is a simple TIC-processing system, designed especially for
points. FileToss is not a "full-featured" TIC processor. It lacks
both "hatching" and file forwarding ability. It merely moves files from
your mailer's inbound file directory to whatever target directories you
specify. It is fast, small, and very easy to set up and use.
II. How does FileToss work?
FileToss can run "stand-alone" or can be called from a batch file.
Quite simply, all you have to do is type "FileToss". It takes no
arguments. There are two configuration files you have to set up
first, FILETOSS.CFG and FILETOSS.BBS. They must exist in the same
directory as the directory from which FileToss.exe is called,
otherwise FileToss won't do very much,. A simple batch file to
use FileToss might look like this:
@echo off
bnu /l:1=38400,8N1 /F
:loop
c:
cd\fd
fd /nounpack
if errorlevel 250 goto mail_in
if errorlevel 245 goto read_mail
if errorlevel 240 goto mail_out
if errorlevel 10 goto user_break
if errorlevel 0 goto stop_bat
:mail_in
c:
cd\fd
fmail toss
if exist c:\fd\file\*.tic goto tic_in
goto loop
:read_mail
c:
cd\fd
call editor.bat
goto loop
:mail_out
c:
cd\fd
fmail scan
goto loop
:tic_in
c:
cd\fd
filetoss
goto loop
:user_break
goto stop_bat
:stop_bat
bnu /u
exit
This batch file assumes that FileToss.exe is in your C:\FD directory
and that the configuration files, FILETOSS.CFG and FILETOSS.BBS are
there, too. In fact, FileToss won't run unless they are in the same
directory.
III. Configuring FileToss - Part 1 - FILETOSS.CFG
FILETOSS.CFG is a simple text file that tells FileToss about your
system. The format of FILETOSS.CFG is simply
STATEMENT=VARIABLE
A sample FILETOSS.CFG file is included. Edit it to reflect your setup.
The sample .cfg file is included here in its entirety and all the
Statements and Variables are explained.
;--------------------------------------------------------------------------
; FILETOSS.CFG Configuration File
;--------------------------------------------------------------------------
;This is the FILETOSS.CFG configuration file. It contains the information
;about your inbound directory and log file.
;
;Make the appropriate changes to this file.
;
;Format rules for FILETOSS.CFG:
;
;All statements must begin in Column 1
;All comments must begin with ";"
;
;The correct format is STATEMENT=VARIABLE
;The STATEMENT must be capitalized!!!!!!!
;All STATEMENTs must have an "=" sign variable
;Leave no blank spaces after the "=" sign
;
;STATEMENTs used by FileToss are INBOUND, REPORT and SCANLIST
;
;Neither INBOUND nor REPORT may reside in the root directory of any drive.
;
;--------------------------------------------------------------------------
;INBOUND is the directory in which your .TIC files can be found.
;Do not use a trailing backslash in your directory name.
;This field is required.
;
INBOUND=C:\FD\FILE
;
;--------------------------------------------------------------------------
;REPORT is the FileToss Log file. You can specify a name and
;directory for your log file.
;
REPORT=C:\FILETOSS\FILETOSS.LOG
;--------------------------------------------------------------------------
;SCANLIST is a text file listing the target directory and names of all
;files processed by FileToss. It can be used with a virus scanner or
;rearchiving program after FileToss has processed your incoming files.
;
SCANLIST=C:\FILETOSS\SCANLIST.TXT
;--------------------------------------------------------------------------
;That's all folks!
IV. Configuring FileToss - Part 2 - FILETOSS.BBS
FILETOSS.BBS is a simple text file, but it _must be set up correctly_.
A sample FILETOSS.BBS file is included. Edit it to reflect your setup.
The sample .bbs file is included here in its entirety.
;--------------------------------------------------------------------------
; FILETOSS.BBS Configuration File
;--------------------------------------------------------------------------
;This is the FILETOSS.BBS configuration file. It contains the information
;about your TIC Areas, and target directories.
;
;Make the appropriate changes to this file.
;
;Format rules for FILETOSS.BBS:
;
;All statements must begin in Column 1
;All comments must begin with ";"
;Each line must contain 2 and only 2 arguments:
;
;Argument 1: The TIC Area tag from the FDN. This may be more than 8
;characters, but FILETOSS will truncate any TIC Area exceeding 8 character.
;
;Argument 2: The Target directory. This tells FILETOSS where to move
;your incoming files. Directories must be terminated with the
;backslash "\".
;
;The TARGET_DIRECTORY must not be the root directory of any drive.
;
;--------------------------------------------------------------------------
;
;TIC Area Target Area Directory
;-------- ---------------------------
NODEDIFF C:\FD\NODELIST\
TOADNET C:\FD\NODELIST\
FIDONEWS C:\FIDONEWS\
SOFTDIST C:\SOFTDIST\
;--------------------------------------------------------------------------
;That's all folks!
Set up all your TIC file areas before running FileToss. If you
omit a TIC area, FileToss will not move those files in that TIC area.
Are you still with me?
V. Output files.
FileToss produces a number of output files.
A. FILETOSS.LOG
A log file, called FileToss.log, is kept of all the TICs
processed by FileToss.
B. FILETOSS.ERR
A log file, called FileToss.err, is kept anytime FileToss
exits prematurely. It contains the date, time and
description of the condition causing the premature exit.
This will help you figure out where you are going wrong,
and help me figure out where I'm going wrong.
(It won't help you figure out where I am going wrong, though.)
C. XXXXXXXX.FTC
FileToss saves all TIC files during processing with the
.FTC extension. If your program aborts for some reason,
your TIC files may be restored by renaming all *.FTC
files to *.TIC. Under normal operation, these files will
be erased.
D. FILES.BBS
FileToss produces a standard FILES.BBS file in your
target directory for use with other file processing
programs.
E. SCANLIST.TXT
FileToss produces a text file for later processing
by your virus scanner/rearchiving utility based on
the SCANLIST= statement in your FILETOSS.CFG file.
VI. The Whole Shebang
This is the sequence of events:
A. User runs FileToss
B. FileToss checks for TIC files.
C. If it finds any, it reads them and moves the associated files
to the proper target directories.
D. FileToss is done.
VII. Operating Tips/Support
This program works for me. It may not work for you. In any event,
all FileToss is guaranteed to do is take up space on your harddrive.
Users with problems may obtain support by following these rules:
1. Report all problems to me via netmail at Fidonet 1:100/560.
All reports should tell me the version number of FileToss, your
directory information, your system configuration, and a copies
of your FILETOSS.ERR, FILETOSS.CFG and FILETOSS.BBS files.
Please archive these files and name them something like
USER.ZIP where USER is your name.
2. Read the FidoNet POINTS echo for messages and announcements
concerning FileToss. I monitor the POINTS echo and I am
available there to answer questions and to take your heat when
the program flops on you.
3. Run FileToss stand-alone a few times before you set it up as
an event or call it from your batch file so you can see what
it is doing and report any problems with it to me.
VIII. Registration
FileToss is freeware; no registration is required. Enjoy it.
IX. Trademarks, Copyrights, etc.
FileToss is copyrighted by Lawrence Gordon.
Lawrence Gordon
4 Waverton
St. Louis, MO 63124
BBS Phone (314) 994-0312
FidoNet 1:100/560
History:
06/30/94 Version 1.0 released.
03/07/95 Version 1.1 released. Added support for standard
FILES.BBS output file. Added support for a SCANLIST.TXT
for later processing by your virus scanner/rearchiver.
Replaced BIOS screen writes with direct screen writes.
Corrected documentation.
09/05/95 Version 1.2 released. Optimized source code and minor
improvements. Corrected FILETOSS.CFG documentation.